home *** CD-ROM | disk | FTP | other *** search
/ Archive Magazine 1996 / ARCHIVE_96.iso / discs / utilities / utility_02 / convrters2 / !WMF->Draw / !Help next >
Text File  |  1996-03-03  |  8KB  |  272 lines
  1.                       
  2.                             CAREWARE
  3.                      
  4.  
  5.                         BETA TEST VERSION.                      
  6.  
  7.  
  8.                   !WMF->Draw Version 1.8a Readme.
  9.  
  10.  
  11.          THIS PROGRAM IS CAREWARE IS IS NOT PUBLIC DOMAIN
  12.                                         ~~~
  13.  
  14. The following have written permission to reproduce this software on
  15. their respective Careware disks :-
  16.  
  17.       Norwich Computer Services : Careware Disks
  18.       Alex Bar  (Furth Germany ): German Careware Disks
  19.  
  20. They will also be supplied with updates.
  21.  
  22. The Author will also upload it to Careware sections on Arcade and NCS bbs.
  23. From which it maybe downloaded.
  24.  
  25. It may NOT be uploaded by anyone other than the Author. 
  26.  
  27. It may NOT be reproduced by any other means ( other than above )
  28. without written consent of the author.
  29.  
  30. Arcade and NCS do NOT have authority to authorise copying by any means other than
  31. above.
  32.  
  33. Acknowledgements
  34. ~~~~~~~~~~~~~~~~
  35.  
  36. Thanks to following for suppling some test cases.
  37.  
  38.  
  39.  Brian Cowan, Keith Milner, Ian Roberts, Vic.
  40.  
  41. Last updated 
  42. ~~~~~~~~~~~~
  43.    Application   : 2nd March   1996
  44.    Documentation : 2nd March   1996
  45.                                        
  46.                       
  47. !WMF->Draw is a Utility for converting Windows Metafiles to Draw
  48.  
  49. This version supports only a subset of Windows Metafile Graphics orders.
  50. If you have files that will not convert please contact the Author as I
  51. am always interested in new test cases and in expanding the program. If
  52. possible please supply small diagram with the problem as these are a
  53. lot easier to debug. 
  54.  
  55.  
  56. Installation
  57. ~~~~~~~~~~~~
  58. The WMF->Draw arc file should have been restored to a directory named
  59. !WMF->Draw. Which should contain the following files :-
  60.  
  61.  
  62.            !Run        : WMF->Draw Startup file.
  63.            !Sprites    : WMF->Draw Application Sprites
  64.            Templates   : Template files
  65.            wmfdraw     : WMF->Draw Application.
  66.            ~~config    : Configuration file for WMF->Draw. 
  67.            !Help       : This file.
  68.  
  69. Tailoring.
  70. ~~~~~~~~~~
  71.  
  72.     The !run file should be altered to suite your requirements :-
  73.  
  74.  
  75.     Modules required :-
  76.  
  77.        The Shared C Library should be loaded as appropriate for
  78.        your setup. The supplied !run file assumes that the C
  79.        shared library module is in !system.modules.
  80.  
  81.        The Floating Point Emulator should be loaded as appropriate for
  82.        your setup. The supplied !run file assumes that the FPEmulator
  83.        module is in !system.modules.  
  84.                        
  85.     Variables required :-
  86.  
  87.        WMFDraw$Dir is required in order for WMF->Draw to find its various
  88.        configuration files.
  89.  
  90.     Storage required :-
  91.  
  92.        !WMF->Draw has been tested with a wimpslot size of 160k
  93.        on a machine with 32k pages. lower values may be possible
  94.        on machines with smaller page sizes.
  95.  
  96.        The file to be converted is loaded into a buffer claimed from
  97.        the next slot. The space is return immediately after the conversion,
  98.        so you should not be able to see the change.
  99.        
  100.        If !WMF->Draw  prompts that it does not have enough memory to process, 
  101.        then !WMF->Draw must be restarted, having made provision that 
  102.        the next slot is large enough.     
  103.  
  104. Operation.
  105. ~~~~~~~~~~
  106.  
  107.      1) First click on the !WMF->Draw icon. This will install the !WMF->Draw
  108.         icon on the icon bar.
  109.  
  110.      2) To convert a WMF file (or EPS file with WMF preview section),
  111.         drag the file to the !WMF->Draw icon on the icon bar.
  112.         This will popup a save Draw window. Drag the Draw
  113.         file icon to the required destination. 
  114.  
  115. Windows BMP Files
  116. ~~~~~~~~~~~~~~~~~
  117.  
  118.       As WMF files may contain objects with BMP bitmaps a side effect of
  119.       !WMF->Draw is that BMP files maybe converted to a Draw file containing
  120.       a sprite. The BMP files must be of type 0x69C.
  121.  
  122.  
  123. Control Options
  124. ~~~~~~~~~~~~~~~
  125.                                                  
  126.       Direct Link
  127.       -----------
  128.  
  129.       Rather than have !WMF->Draw prompt for the target file, it is possible
  130.       to set a default path and have the target name created as default path
  131.       plus filename. To do this you drag the Draw file icon to the target
  132.       directory or application and set the Direct option. With the direct
  133.       option set the output Draw file will automatically be created.
  134.  
  135.       Note if you use this option sensibly with an application then the
  136.            receiving application must support the Draw file type.
  137.  
  138.               
  139. Current Restrictions
  140. ~~~~~~~~~~~~~~~~~~~~      
  141.       
  142.       WMF related
  143.       ----------
  144.  
  145.       Only a subset of Graphics orders currently supported.
  146.  
  147.  
  148. Config File
  149. ~~~~~~~~~~~
  150.   
  151.   The format of the config file is
  152.  
  153.      List of Draw fonts 
  154.      
  155.      ## terminator
  156.  
  157.      List of WMF fonts with corresponding Draw font number
  158.      Font baseline Percentage 
  159.  
  160.      i.e if baseline is at 20% of font height input 20.
  161.  
  162.      Baseline for Default font is hardcoded 20%
  163.       
  164. WMF File type
  165. ~~~~~~~~~~~~~~~~
  166.  
  167.        The WMF file type is 412
  168.  
  169.  
  170. Copyright & Contributions
  171. ~~~~~~~~~~~~~~~~~~~~~~~~~
  172.  
  173. This software carries no warranty, either express or implied. 
  174. I can not guarantee that it is free of bugs or give any warranty
  175. about itæs suitability for use.
  176.                                                    
  177. The status of !WMF->Draw is Careware.
  178.  
  179. Permission is granted to Norwich Computer Services to reproduce
  180. !WMF->Draw on Careware disks.
  181.  
  182. The software will be uploaded to Careware sections on Arcade
  183. Bulletin Boards, it may only be uploaded by the author.
  184. It may not be uploaded by anybody else or to any other board.
  185.                             
  186. This software may NOT be distributed by public domain libraries.
  187.  
  188. If you did not obtain the software from a Careware disk or by subscription
  189. to one of the Bulletin Board Careware sections.
  190. ( i.e. You obtained it from a friend who does, say. ) 
  191. Then please send a contribution to either
  192.  
  193. Heatherley Cheshire Home
  194. Effingham Lane,
  195. Copthorne,
  196. Sussex.
  197. RH10 3HS.
  198.  
  199. Registered Charity Number : 218186
  200. The software may not otherwise be copied or distributed without
  201. the Authors written permission.
  202.  
  203. Copyright remains solely the authors. (C) Keith Sloan 
  204.  
  205. Contact
  206. ~~~~~~~
  207.  
  208. If you find problems or want to make suggestions for improvements then
  209. please contact me at either of the following.
  210.  
  211.  Internet : keiths@cix.compulink.co.uk
  212.  
  213. Wanted
  214. ~~~~~~
  215.                    
  216. In the interest of enhancing this enhance this application I
  217. would like to obtain the following :-
  218.  
  219.     Sample WMF files that fail to convert correctlty
  220.  
  221. Many Thanks
  222.                     
  223.  
  224.  
  225. Version History.
  226. ~~~~~~~~~~~~~~~~    
  227.           
  228.      Beta 1.0 : Version supplied to M Roscoe.
  229.  
  230.      Beta 1.1 : 3rd Jan 1993
  231.  
  232.         Converts all sample WMF files at present.
  233.  
  234.      Beta 1.2 : 5th Jan 1993
  235.  
  236.         Fixes for text output and use of config file
  237.  
  238.      Beta 1.3 : 29th Jan 1993
  239.  
  240.        Some bit maps operations supported.
  241.  
  242.      Beta 1.4 : 4th April 1993
  243.  
  244.        Fix for default font height.
  245.        support WMF Preview section of EPS files
  246.  
  247.      Beta 1.5 : 6th April 1993
  248.  
  249.        Fix for padding in text.
  250.        support loading of BMP files.
  251.  
  252.      1.6      : 7th Feb 1995
  253.  
  254.        fix for polypolgon
  255.        allow for base line in font alignment
  256.                             
  257.      1.7/1.7a : 28th Jan 1996
  258.  
  259.        set text alignment supported.
  260.        Only allow for baseline in text with descenders ( 1.7a)
  261.  
  262.      1.8 : 2nd March 1996
  263.    
  264.        Allow for GDI 0x0105 ( Undocumented in 2 books )
  265.        Allow for corrupted files i.e. avoid abend when length
  266.        exceeds remaining available bytes.
  267.        Fix PolyPolygon to address values.
  268.        Remove debugging info on buffer expansion.
  269.        Fix path bounding box.
  270.  
  271.      1.8a : Fix flex bug introduced in 1.8
  272.